home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / ARGONET / PD / GAMES / NETHACK.SPK / ReadMe's / UL_ReadMe < prev   
Text File  |  1991-12-09  |  6KB  |  111 lines
  1.  
  2.  
  3.             UnixLib v3.5c (29/11/1991)
  4.  
  5.  
  6.     UNIX is a registered trademark of AT&T Bell Laboratories.
  7.  
  8.     This is a complete replacement ANSI compliant C library for use
  9. with Acorn RiscOS ANSI C Release 3.0/3.1A/3.1B/4.0. It incorporates a
  10. full Version 7 UNIX system call interface, with some common System V and
  11. 4.3 BSD C libraries. There is *no* Acorn software in this library - take
  12. note Acorn! ;-)
  13.  
  14.     Csh style command line redirection is now inbuilt to UnixLib.
  15. UnixLib programs that are invoked direct from OS_CLI scan the command line
  16. for redirections at the same time as performing argument processing. UnixLib
  17. programs invoked as children of other UnixLib programs inherit the parent's
  18. file descriptor set (as in UNIX), and therefore do not perform this scanning.
  19. Redirection directives that are supported are: ">", ">>", ">&", ">>&", "<".
  20.  
  21.     Programs compiled using UnixLib now assume UNIX style pathnames
  22. at all times. In order to use RiscOS style names you must specify a full
  23. RiscOS pathname including the filesystem ("FS::Media.Path"), or specify a
  24. pathname from the root, current, library, upper, or user-root directories
  25. ("$.Path", "@.Path", "%.Path", "^.Path", or "&.Path"), or commence the
  26. pathname with a RiscOS variable reference ("<Var>.Path" or "<Var>Path").
  27. Filenames not matching these patterns will be translated as described below.
  28.  
  29.     There are environment variables specific to UnixLib programs;
  30. some are new to v3.5c and others have had their names changed:
  31.  
  32.     Unix$uid: If set, then it's value is used to set the UNIX uid and the
  33. Escape (SIGINT) character is set to '^C' (ctrl C). If unset the Escape
  34. character is set to '^[' as normal. The Escape character is always reset at
  35. termination.
  36.     Unix$tty: controls which terminal file programs use - if unset or set
  37. to "/dev/console" or "/dev/tty" then the console (Archimedes keyboard/screen)
  38. is assumed; if set to "/dev/rs423" then the RS423 port is used. Other names
  39. may be allocated in future for multiple serial I/O ports, Econet, etc. Note
  40. that these names may be used by UnixLib programs to open the terminal
  41. devices.
  42.  
  43.     UNIX -> RiscOS filename translation:
  44.  
  45.     Pathnames referring to UNIX devices (of the form "/dev/xxx") are
  46. treated specially and refer to appropriate devices. Unrecognised devices
  47. are translated to "xxx:". Current recognised devices are "/dev/tty",
  48. "/dev/console", "/dev/rs423" and "/dev/null".
  49.     Variables of the form UnixFS$/xxx are used to alias UNIX pathnames
  50. of the form "/xxx", "/usr/xxx" or "/var/xxx". I.e. UnixFS$/etc controls the
  51. translation of "/etc", "/usr/etc" and "/var/etc". The files in "etc" on the
  52. distribution disk should be present in this directory. If you have a hard
  53. disk, just one copy of "etc" should be present on the hard disk, and
  54. UnixFS$/etc should be set to something like "adfs::4.$.etc".
  55.     In a similar way, UnixFS$/tmp, UnixFS$/bin and UnixFS$/usr can
  56. be used to alias "/tmp", "/bin", and "/usr". Note however that UnixFS$/bin
  57. will be consulted to translate "/usr/bin" before UnixFS$/usr is consulted
  58. to translate "/usr". A pathname commencing "/xxx" where UnixFS$/xxx is unset
  59. defaults to "$.xxx". A pathname commencing "/usr/xxx" where UnixFS$/xxx is
  60. unset and UnixFS$/usr is unset defaults to "$.usr.xxx".
  61.     "/tmp" and "/usr/tmp" are used by UnixLib programs for temporary
  62. files. UnixFS$/tmp should be set to a suitable directory, preferably on a
  63. hard disk.
  64.     "/bin" and "/usr/bin" are expected by some UNIX software to contain
  65. standard UNIX utilities (ls, cat, sh, etc.). If necessary, UnixFS$/bin should
  66. be set to a directory containing UNIX utility programs.
  67.     "/pipe" is used to store temporary files for the pipe() system call.
  68. Preferably UnixFS$/pipe should be set to a directory on a hard disk or RAM
  69. disk for decent throughput.
  70.     UNIX style filenames can now contain a special first component
  71. to indicate the RiscOS File System (FS) and media: "/adfs::4/etc/passwd"
  72. translates to "adfs::4.$.etc.passwd". Note that in this case the "/etc" is not
  73. aliased using UnixFS$/etc, for what should be obvious reasons. Similarly
  74. "adfs::4/etc/passwd" and "adfs::4.etc.passwd" are the same name.
  75.     Filename suffix translation can now be customised. The variable
  76. UnixFS$sfix can be set to a colon separated value list of filename
  77. suffixes that are to be aliased to RiscOS subdirectories. If it is unset
  78. the default list is "a:c:f:h:i:l:o:p:s:y". I.e. "hero.c" gets translated
  79. to "c.hero".
  80.     Note that UNIX programs which wish to use pathnames with initial
  81. components that look like RiscOS FS/drive specifiers will have to be
  82. modified.
  83.  
  84.     All user settable environment variables particular to UnixLib are
  85. prefixed with Unix$ or UnixFS$. However certain state information internal
  86. to UnixLib is stored in variables prefixed with UnixLib$ - such variables
  87. should be ignored and not altered or deleted. UnixLib$dir (set by the !Alias
  88. command file in this distribution) is only used when compiling with UnixLib,
  89. and does not need to be set for UnixLib compiled programs to run.
  90.  
  91.     The standard UNIX environment variables which control the behaviour
  92. of some of the C libraries are as normal - SHELL, TERM, TERMCAP, etc.
  93. Note that system() ignores the requirement for a shell if SHELL is unset,
  94. but calls SHELL with the '-c' option (as per UNIX) is it is set. I.e. if you
  95. have GNU bash in adfs::4.$.library you should set SHELL to
  96. "adfs::4.$.library.bash".
  97.  
  98.  
  99.     I can be contacted at:
  100.  
  101.         Mail:    Chandos Hall, Granby Row, Manchester, M1 3QJ, U.K.
  102.         Tel.:    (061) 200 3131
  103.         Email:    rogersh%p4@cs.man.ac.uk
  104.  
  105.     After July 1992 I can be contacted at:
  106.  
  107.         Mail:    The Beeches, North Road, Sherborne, Dorset, U.K.
  108.  
  109.  
  110.         H.Rogers
  111.